Closes #966

Description

This PR:

1. Adds the one-time Widgets intro screen and in-sheet flow, routeing the drawer Widgets entry to either the intro or the wallet overview widgets section based on whether the intro has been seen.
2. Moves the Add Widget gallery plus widget preview/edit screens into a large gradient-backed bottom sheet with internal in-sheet navigation.
3. Updates the Add Widget gallery to match the Figma v61 layout, including large sheet sizing, scrolling behavior, equal picker card heights, reused widget preview components, and reliable full-card taps.
4. Rewires save/edit/back behavior so selected widgets save through the existing widget flow, append to the current widget set, and navigation lands on the wallet overview widgets section afterwards.
5. Adds the widget flow journeys for android-cli, Compose/navigation coverage, and the changelog fragment for this user-facing change.

Preview

QA Notes

Manual Tests

Optional local QA patches, for a disposable test build only. Apply one or both before ./gradlew installDevDebug; do not commit them. Undo by running git apply -R with the same patch.

Shorten backup retry/failure waits from minutes to seconds:

git apply <<'PATCH'
diff --git a/app/src/main/java/to/bitkit/repositories/BackupRepo.kt b/app/src/main/java/to/bitkit/repositories/BackupRepo.kt
--- a/app/src/main/java/to/bitkit/repositories/BackupRepo.kt
+++ b/app/src/main/java/to/bitkit/repositories/BackupRepo.kt
@@ -699,10 +699,10 @@ class BackupRepo @Inject constructor(
         private const val TAG = "BackupRepo"
 
         private const val MINUTE_IN_MS = 60_000
-        private const val BACKUP_DEBOUNCE = 5000L // 5 seconds
-        private const val BACKUP_CHECK_INTERVAL = 60 * 1000L // 1 minute
-        private const val FAILED_BACKUP_CHECK_TIME = 30 * 60 * 1000L // 30 minutes
-        private const val FAILED_BACKUP_NOTIFICATION_INTERVAL = 10 * 60 * 1000L // 10 minutes
+        private const val BACKUP_DEBOUNCE = 500L // QA: 0.5 seconds
+        private const val BACKUP_CHECK_INTERVAL = 2 * 1000L // QA: 2 seconds
+        private const val FAILED_BACKUP_CHECK_TIME = 10 * 1000L // QA: 10 seconds
+        private const val FAILED_BACKUP_NOTIFICATION_INTERVAL = 5 * 1000L // QA: 5 seconds
         private const val SYNC_STATUS_DEBOUNCE = 500L // 500ms debounce for sync status updates
         private val VSS_TIMESTAMP_TIMEOUT = 60.seconds
     }
PATCH

Shorten Home widget headline/fact rotation while visually checking saved widgets:

git apply <<'PATCH'
diff --git a/app/src/main/java/to/bitkit/ui/screens/wallets/HomeViewModel.kt b/app/src/main/java/to/bitkit/ui/screens/wallets/HomeViewModel.kt
--- a/app/src/main/java/to/bitkit/ui/screens/wallets/HomeViewModel.kt
+++ b/app/src/main/java/to/bitkit/ui/screens/wallets/HomeViewModel.kt
@@ -184,14 +184,14 @@ class HomeViewModel @Inject constructor(
     private suspend fun startArticleRotation(articlesList: List<ArticleModel>) {
         while (_uiState.value.showWidgets && articlesList.isNotEmpty()) {
             _currentArticle.update { articlesList.randomOrNull() }
-            delay(30.seconds)
+            delay(3.seconds)
         }
         _currentArticle.update { null }
     }
 
     private suspend fun startFactsRotation(factList: List<String>) {
         while (_uiState.value.showWidgets && factList.isNotEmpty()) {
             _currentFact.update { factList.randomOrNull() }
-            delay(20.seconds)
+            delay(3.seconds)
         }
         _currentFact.update { null }
     }
PATCH

Use Dev Settings → Reset widgets intro flag to retest the first-run widgets path, and Dev Settings → Reset Widgets State when you want the default widget list again.

• 1. Drawer → Widgets with intro unseen: Widgets Intro opens with "Hello, Widgets", "View & Organize", and "Add Widget" visible.
• 2. Widgets Intro → Add Widget → Bitcoin Weather → Save Widget: Add Widget opens as an in-sheet gallery, the intro remains visible behind the backdrop, Weather preview opens in-sheet, and save lands on the wallet overview widgets section with Bitcoin Weather appended last.
• 3. Widgets Intro → View & Organize with widgets enabled: lands on the wallet overview widgets section.
• 4. Drawer → Widgets with intro already seen and widgets enabled: wallet overview widgets section opens directly and "Hello, Widgets" intro screen is not visible.
• 5. Widgets disabled → Drawer → Widgets: Add Widget opens in-sheet with disabled picker cards and Enable in Settings visible; Enable in Settings opens Widgets Settings.
• 6. Wallet Overview widgets section → Add Widget → scroll to Bitcoin Calculator → tap card: the large Add Widget sheet scrolls without content hiding behind the sheet top area, and Calculator preview opens in-sheet.
• 7a. regression: Add Widget gallery → tap Bitcoin Price chart line: Price preview opens in-sheet and no chart tooltip opens.
  • 7b. regression: Add Widget gallery → tap Bitcoin Headlines content: Headlines preview opens in-sheet and no external URL opens.
• 8. Pubky authenticated session restored → Profile Choice: auto-nav lands on Profile instead of staying on the choice screen.
• 9. Optional backup timing patch applied + stale WALLET backup status present at launch → Settings → Backup: WALLET leaves running=true and completes after the shortened debounce instead of waiting for another data change.

Automated Checks

• Compose UI tests added/updated for Widgets intro actions, drawer Widgets routing, Add Widget gallery layout/scrolling/safe-area behavior, reliable picker taps, and converted sheet previews.
• Unit coverage added for widget route mapping in app/src/test/java/to/bitkit/ui/sheets/WidgetsRouteTest.kt.
• Unit coverage added for stale running backup retry in app/src/test/java/to/bitkit/repositories/BackupRepoTest.kt.
• Unit coverage added for Pubky restored-session profile navigation in app/src/test/java/to/bitkit/ui/screens/profile/PubkyChoiceViewModelTest.kt.
• Android CLI journeys added under journeys/widgets/ for widgets intro and add widgets flow.
• Ran ./gradlew compileDevDebugKotlin compileDevDebugAndroidTestKotlin detekt testDevDebugUnitTest.
• Ran ./gradlew connectedDevDebugAndroidTest -Pandroid.testInstrumentationRunnerArguments.class=to.bitkit.ui.screens.widgets.AddWidgetsSheetContentTest.
• CI: build, lint, detekt, and E2E checks are green on the latest pushed commit.